API Reference

Use our API to build a custom integration to supercharge your loyalty marketing program

Authorization

Get a User

  • You will need a user with access to your Marsello account.
  • This only works with users that have access to exactly one Marsello account.
  • To create new users for use with the API please invite them inside Marsello Dashboard > Settings > Users

Get a token

Replace with your details and run the command or import into Postman.

Use the following client id: ea711d08-01a1-4c12-957e-9a26809372ed.

Use your username and password.

Curl

curl --location --request POST 'https://marselloexternal.b2clogin.com/marselloexternal.onmicrosoft.com/B2C_1_ROPC/oauth2/v2.0/token' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'grant_type=password' \
--data-urlencode 'scope=https://dev.marsello.com/scope/write.all https://dev.marsello.com/scope/read.all' \
--data-urlencode 'username=**YOUR USERNAME**' \
--data-urlencode 'password=**YOUR PASSWORD**' \
--data-urlencode 'client_id=ea711d08-01a1-4c12-957e-9a26809372ed'

Javascript(Axios)

var axios = require('axios');
var qs = require('qs');
var data = qs.stringify({
  'grant_type': 'password',
  'scope': 'https://dev.marsello.com/scope/write.all https://dev.marsello.com/scope/read.all',
  'username': '**YOUR USERNAME**',
  'password': '**YOUR PASSWORD**',
  'client_id': 'ea711d08-01a1-4c12-957e-9a26809372ed'
});
var config = {
  method: 'post',
  url: 'https://marselloexternal.b2clogin.com/marselloexternal.onmicrosoft.com/B2C_1_ROPC/oauth2/v2.0/token',
  headers: {
    'Content-Type': 'application/x-www-form-urlencoded'
  },
  data : data
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

Use the token

For all requests you will need to add an Authorization header to each request with this token.

Authorization: Bearer **your token goes here**

Test your queries in the browser below by clicking the Authorize button then try the requests.